package com.zui.manager;

import java.io.Serializable;
import java.util.Collection;
import java.util.Iterator;
import java.util.List;

import org.hibernate.Criteria;
import org.hibernate.criterion.Criterion;
import org.hibernate.criterion.DetachedCriteria;
import org.hibernate.criterion.Order;

import com.zui.util.Page;

public interface SessionDao<T, ID extends Serializable> {

	public T findById(Class<T> c, ID id);

	public T loadById(Class<T> c, ID id);

	public List<T> loadAll(Class<T> c);

	public T saveEntity(T entity);

	public void updateEntity(T entity);

	public void saveOrUpdateAll(Collection<T> entities);

	public void deleteEntity(T entity);

	public void deleteEntityById(Class<T> c, ID id);

	/**
	 * 批量删除
	 * 
	 * @param entities
	 */
	public void deleteAll(Collection<T> entities);

	/**
	 * 通过合并的方式更新对象
	 * 
	 * @param entity
	 *            void
	 */
	public void merge(T entity);

	/***************************************************************************
	 * ------------------------------使用HQL语句-------------------------------- *
	 **************************************************************************/

	/**
	 * 使用HQL语句进行对象的查询
	 * 
	 * @param hsql
	 *            查询语句
	 * @return 符合条件的对象
	 */
	public T getEntity(String hsql);

	/**
	 * 使用命名的HQL语句更新数据
	 * 
	 * @param queryName
	 * @param values
	 */
	public int updateByNamedQuery(String queryName, Object[] values);

	/**
	 * 使用命名的HQL语句查询数据
	 * 
	 * @param queryName
	 * @return
	 */
	public List<T> findByNamedQuery(String queryName);

	/**
	 * 使用带参数的命名HSQL语句查询数据
	 * 
	 * @param queryName
	 * @param values
	 * @return
	 */
	public List<T> findByNamedQuery(String queryName, Object[] values);

	/**
	 * 使用带命名参数的命名HSQL语句�查询数据
	 * 
	 * @param queryName
	 * @param paramNames
	 * @param values
	 * @return
	 */
	public List<T> findByNamedQuery(String queryName, String[] paramNames,
			Object[] values);

	/**
	 * 使用HQL语句查询数据 ，返回Iterator
	 * 
	 * @param queryString
	 * @return
	 */
	public Iterator<T> iterate(String queryString);

	/**
	 * 使用带参数HSQL语句查询数据，返回Iterator
	 * 
	 * @param queryString
	 * @param values
	 * @return
	 */
	public Iterator<T> iterate(String queryString, Object[] values);

	/***************************************************************************
	 * -----------------------------Criteria查询---------------------------- *
	 **************************************************************************/

	/**
	 * 创建与会话无关的查询数据
	 */
	public DetachedCriteria createDetachedCriteria(Class<T> c);

	/**
	 * 创建与会话绑定的查询数据标准对象
	 * 
	 * @return
	 */
	public Criteria createCriteria(Class<T> c);

	/**
	 * 根据Criterion条件创建Criteria,后续可进行更多处理,辅助函数.
	 */
	public Criteria createCriteria(Class<T> c, Criterion... criterions);

	/**
	 * 使用指定的检索标准检索数据，返回部分记录
	 * 
	 * @param criteria
	 * @param firstResult
	 * @param maxResults
	 * @return
	 */
	public List<T> findByCriteria(DetachedCriteria criteria, int firstResult,
			int maxResults);

	/**
	 * 通过动态查询条件进行查询
	 * 
	 * @param criterion
	 * @return List<T>
	 */
	public List<T> findByCriteria(Class<T> c, Criterion... criterion);

	/**
	 * 使用指定的检索标准检索数据，返回指定范围的记录
	 * 
	 * @param criteria
	 * @return
	 */
	public Integer getRowCount(DetachedCriteria criteria);

	/**
	 * 使用指定的检索标准检索数据，返回指定统计记录
	 * 
	 * @param criteria
	 * @param propertyName
	 * @param StatName
	 *            (max,min,avg,sum)
	 * @return
	 */
	public Object getStatValue(DetachedCriteria criteria, String propertyName,
			String StatName);

	/**
	 * 通过给定的一个对象，查找与其匹配的对象，表关联比较多时，可根据自己需要扩展
	 * 
	 * @param entity
	 * @return List<T>
	 */
	public List<T> findByExample(T entity);

	/***************************************************************************
	 * -------------------------Others ----------------------------------------*
	 **************************************************************************/

	/**
	 * 强制立即更新缓冲数据到数据库（否则仅在事务提交时才更新）
	 */
	public void flush();

	/**
	 * 清空缓存
	 * 
	 * void
	 */
	public void clear();
	
	/**
	 * 相当于detach, 使Entity的状态从Persistent到Detached
	 * @param entity
	 */
	public void evict(T entity);

	/**
	 * 根据criteria和orderList进行分页查询。
	 * 
	 * 出于性能考虑排序信息请勿放在criteria里，由本方法负责。
	 * 
	 * @param criteria
	 *            查询条件
	 * @param page
	 *            分页信息
	 * @param orderList
	 *            定制化的排序列表
	 * @return 包含分页信息的对象列表。对象为根对象。
	 * @deprecated
	 */
	public List<T> findByCriteria(DetachedCriteria criteria, Page page,
			List<Order> orderList);

	/**
	 * 根据criteria进行分页查询。
	 * 
	 * @param criteria
	 *            查询条件
	 * @param page
	 *            分页信息
	 * @return 对象为根对象。
	 * @deprecated
	 */
	public List<T> findByCriteria(DetachedCriteria criteria, Page page);

	/**
	 * 无分页查询
	 * 
	 * @param criteria
	 * @return 根对象的列表。
	 */
	public List<T> findByCriteria(DetachedCriteria criteria);

	/**
	 * 按属性查找唯一对象.
	 */
	public T findUniqueByProperty(Class<T> c, String propertyName, Object value);

	public List<T> createSQLQuery(String nativeSql);
	/**
	 * 根据criteria和orderList进行分页查询。
	 * 
	 * 出于性能考虑排序信息请勿放在criteria里，由本方法负责。
	 * 
	 * @param criteria
	 *            查询条件
	 * @param page
	 *            分页信息
	 * @param orderList
	 *            定制化的排序列表
	 * @return JQGridListImpl,包含分页信息的对象列表。对象为根对象。
	 */
	public List<T> findByCriteriaForJQGrid(DetachedCriteria criteria, Page page,
			List<Order> orderList);
	/**
	 * 根据criteria进行分页查询。
	 * 
	 * @param criteria
	 *            查询条件
	 * @param page
	 *            分页信息
	 * @return 对象为根对象。
	 */
	public List<T> findByCriteriaForJQGrid(DetachedCriteria criteria, Page page);
}
